home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / (A)TB / (A)TBX.ADF / WB2.0 / CPU_mon / PM.doc < prev    next >
Text File  |  1992-03-19  |  3KB  |  86 lines
  1. TABLE OF CONTENTS
  2.  
  3.                 NAME
  4.   PM v37.5 - Copyright (c) 1992 by MKSoft Development (Requires 2.0)
  5.  
  6.    SYNOPSIS
  7.     PM - A CPU Load Monitor
  8.  
  9.    FUNCTION
  10.    PM is a tool that monitors the Amiga system's CPU usage using some
  11.    hooks that are available in 2.04 EXEC.  The program uses the high
  12.    resolution EClock timer to get real time values for the amount of
  13.    time the processor spends running tasks and the amount of time it
  14.    spends between tasks (in task switch and in sleep).
  15.  
  16.    PM has full ReadArgs commandline input and it can also run from
  17.    the Workbench.  (The tooltypes match the ReadArgs arguments)
  18.    PM can also be started by a Project Icon, in which case it will
  19.    use the tooltypes from the project icon.
  20.  
  21.    PM has another feature and that is it can watch a specific task.
  22.    There is a TASK keyword which will make it watch the task in
  23.    question. This can be usefull in order to see exatly how much of
  24.    the system performance is spend on just that task.
  25.  
  26.    When PM is not watching a specific task, it removes its own
  27.    processing from the total time such that any overhead it may cause
  28.    is not noticed. When PM is monitoring a specific task, PM's over-
  29.    head is not counted as part of the task's CPU usage.
  30.  
  31.    There is also a PROP-gadget that controls the speed at which the
  32.    results are reported.
  33.  
  34.    The two numbers at the bottom (when statistics are not turned off)
  35.    are the weighted average CPU usage and the instantanious CPU
  36.    usage.
  37.  
  38.    When monitoring a single task, the window titlebar will display
  39.    the task name.
  40.  
  41.     Example usage:
  42.  
  43.         PM      ; Use the default settings
  44.         PM RATE 15  ; Set the rate to 15/100 seconds.
  45.         PM TASK MyTask  ; Watch "MyTask"  (Uses FindTask(), not CLI
  46.            name)
  47.         PM NOSIZE   ; Do not have the size/prop gadget.
  48.  
  49.     PM will only let itself be installed once as a global monitor.
  50.   However, you can have PM monitor any number of tasks. PM will do
  51.   its best to not confuse the system on exit. It will beep the
  52.   display if it can not unhook itself from the system. When this
  53.   happens it means that PM was unable to remove the hook due to the
  54.   fact that something else has hooked into the system on top of PM.
  55.  
  56.    INPUTS
  57.     (Command Line Arguments or Icon ToolTypes:)
  58.  
  59.     LEFT/N      Left edge for the window.    Default=<none>
  60.     TOP/N       Top edge for the window.     Default=<none>
  61.     WIDTH/N     Inner width of the window.   Default=228
  62.     HEIGHT/N    Inner height of the window.  Default=40
  63.     RATE/K/N    Rate of display in 1/100 sec Default=100   (1.00 sec)
  64.     TASK/K      Task to monitor              Default=<global CPU>
  65.     PUBSCREEN/K Public screen name           Default=<default>
  66.     NOSIZE/S    Switch off size/prop gadget
  67.     NOSTATS/S   Turn off numerical statistics
  68.  
  69.   RESULTS
  70.    A window that shows the CPU usage...
  71.  
  72.   NOTES
  73.    The accuracy is so high that PM can even notice the task switch
  74.    overhead of the system. This "overhead" is considered part of the
  75.    CPU idle time (not CPU task time) and thus it may be hard to get a
  76.    full 100% utilization if task switching is still going on.
  77.  
  78.    Special thanks to "talin" for the nice icon!
  79.  
  80.   SEE ALSO
  81.    "A master's secrets are only as good as the
  82.     master's ability to explain them to others."  -  Michael Sinz
  83.  
  84.   BUGS
  85.    None?
  86.